Citizen Portal

The Lucity Citizen Portal must be installed at the server on which the application will reside.

Important:  Lucity recommends closing all Windows applications before running the Lucity software setup.

Note:   If the Citizen Portal will be used as part of a public web site, it must be installed on a server in the DMZ.

Requirements and Prerequisites

• General hardware and software requirements >>
• The Lucity Server installation must be completed before installing the Citizen Portal.

Specific Requirements

• .NET Framework 4.8 (Full)
• ASP.NET 4.5 should be installed and enabled in IIS.

• When using IIS 7 or higher, the following Role Services are required:

  • IIS 6 Metabase Compatibility
  • IIS 6 WMI Compatibility

Supported Browsers

• Internet Explorer 7.0, 8.0, 9.0, 10.0, and 11.0.
• Firefox 2 or higher
• Although the application may function in other browsers, Lucity does not recommend them.

Note:  Lucity Citizen Portal is supported in a web-farm configuration if the load balancer is configured to use sticky sessions. Please consult your load-balancing software for details on configuring sticky sessions.

How to Install Citizen Portal

1. Open the Lucity install media and run Setup.exe. The following screen appears:

   

2. Select the Citizen Portal option on the menu. The following window appears:

   

3. • Read the Welcome screen. Click to continue. The Database Connection Information dialog appears:

     

   • Use the Instance Name field to identify the SQL Server instance that hosts the Lucity database.
   • Use the Database Name to identify the database that stores your Lucity data. This is typically called Lucity.
   • Note:   The databases must already exist. The installation will not create the database for you.
4. Click to continue. The Existing Site dialog appears:

   Note: This screen appears only if more than one site is defined in IIS.

   

5. Select an existing web site where the virtual directory for the Citizen Portal is located.

6. Click to continue. The Virtual Directory dialog appears:

   • Lucity recommends using the default settings. The Physical Directory defaults to the root of the existing web site.

   

7. Click to continue. The SSL Option dialog appears:

   

8. To use the Citizen Portal over SSL/TLS,, check the Use SSL/TLS option. Agency administrators are responsible for configuring the site to support SSL/TLS by installing a valid certificate and creating an https binding if these items do not already exist.

   Note: If this option is enabled and an administrator does not complete the required SSL/TLS configuration steps in IIS, the Citizen Portal will not run properly.

9. Click to continue. The Web Gateway User dialog appears:

   

10. The dialog informs the reader that the Username and Password provided will be used to create a new database user. Citizen Portal will use this account to query application configuration information. The designated user will be granted minimal database privileges and access to several Lucity stored procedures.

    Consider the following when creating a Username:

    • Lucity recommends using the default Username provided.

    • If you choose to use a different username, it should not be that of an administrative user or any existing Lucity user. If you enter a Username that is disallowed, you'll be prompted to enter an alternative Username.

      Note:  You cannot use Lucity_User for this login.

    Consider the following when creating a Password:

    • If the Username entered already exists, the installation will verify the Password by attempting to connect to the database as this user.

    • Lucity recommends a Password of at least eight characters for new accounts.

      Note:   By default, SQL Server enforces an agency's local or domain password policy when evaluating passwords for database users. Please ensure that the password you choose meets your organization's password policy.

11. Click to continue. The Database Administrator Login dialog appears:

    

    DBA Credentials are required to create or update the specified user account. Provide SQL Server system administrator credentials or some other database administrator account.

    Note: If the credentials entered aren't sufficient, an error message will detail the possible problems.

12. Click to continue. The Ready dialog appears:

    

    Notes:   

    • IIS will be restarted during the installation.

    • It may take up to one minute to create the virtual directory, depending on the speed of the web server. Please wait for this process to be completed.

    More Information about Lucity's Data Collection Policy >>

13. Click to begin the installation. This process may take a few minutes. The following window appears when the installation is complete:

    

Notes:   

• Now that the software has been installed successfully, additional setup is required to fully utilize Lucity Citizen Portal. See the Lucity Administration Tool Help Guide > How To > Web Citizen Setup.
• This installation creates a Web Task Runner process that handles various background tasks for the application.